Skip to main content

Get Statement Analysis

POST https://api.sat.tausi.africa/v1/airtelmoney/upload_airtelmoney_pdf

This analyses the pdf and generates the report. The response is in a json format.

Header Requirements

  • Authorizaion --required

Body Params

  • file --required
  • fullname --required
curl example request
curl -X 'POST' 'https://api.sat.tausi.africa/v1/airtelmoney/upload_airtelmoney_pdf'
-F fullname=Hussein \
-F 'file=@AirtelMoney_7876543_Statement.pdf' \
-H 'Authorization: Bearer XXXXXXXXXXX' \

Response Sample

  1. Status OK Response
200 OK
{
"info": {
"owners_number": 25568411XXXX,
"start_date": "2024-01-22 00:00:00",
"end_date": "2024-02-21 00:00:00",
"total_days": 31,
"total_active_days": 19
},
"profile": {
"current_wallet_balance": 18399,
"turnover": 3603541,
"number_of_transactions": 51
},
"cashin_flow": {
"total_cash-in_flow": 1780000.0,
"cash-in_flow_to_turnover_percentage": 49.4,
"cash-in_flow_transactions": 17,
"cash-in_trans_to_total_trans_percentage": 33.33
},
"cashout_flow": {
"Total_cash-out_flow": 1823541.0,
"Cash-out_flow_to_turnover_percentage": 50.6,
"Cash-out_flow_transactions": 34,
"Cash-out_trans_to_total_trans_percentage": 66.67
},
"kamilisha": {
"total_Amount_Disbursed": 0.0,
"max_Amount_Disbursed": 0,
"number_of_Loans_disbursed": 0,
"last_loan_amount": 0.0,
"last_day_borrowed": "",
"total_amount_Repaid": 0.0,
"last_amount_repaid": 0.0,
"last_day_repaid": ""
},
"luku": {
"Total_amount_used_to_buy_luku": 0.0,
"Maximum_amount_used_to_buy_luku": 0.0,
"Number_of_times_bought_luku": 0,
"Average_amount_bought_luku": 0.0,
"Last_time_bought_luku": "",
"Last_amount_bought_luku": ""
},
"yatosha": {
"total_amount_spent_on_yatosha": 0.0,
"max_amount_spent_on_yatosha": 0.0,
"number_of_times_bought_yatosha": 0,
"average_amount_spent_on_yatosha": 0.0,
"last_day_bought_yatosha": "",
"last_amount_spent_on_yatosha": 0.0
},
"agent_deposit": {
"total_amount_deposited": 985000.0,
"max_amount_deposited": 600000.0,
"number_of_times_deposited": 8,
"average_amount_deposited": 123125.0,
"last_day_deposited": "2024-02-21 00:00:00",
"last_amount_deposited": 50000.0,
"nunique_agents_deposited": 2
},
"agent_withdraw": {
"total_amount_withdrawn_via_agent": 187898.0,
"maximum_amount_withdrawn_via_agent": 63173.0,
"number_of_times_withdrawn_via_agent": 6,
"average_amount_withdrawn": 31316.0,
"last_time_withdrawn_via_agent": "2024-02-21 00:00:00",
"last_amount_withdrawn": 6004.0,
"nunique_agents_withdrawn": 6
},
"money_sent_p2p": {
"total_amount_sent_to_peer": 274847.0,
"max_amount_sent_to_peer": 51125.0,
"number_of_times_sent_to_peer": 14,
"average_amount_sent_to_peer": 19632.0,
"last_day_sent_to_peer": "2024-02-21 00:00:00",
"last_amount_sent_to_peer": 15350.0
},
"money_received_p2p": {
"total_amount_received_from_peer": 295000.0,
"max_amount_received_from_peer": 50000.0,
"number_of_times_received_from_peer": 8,
"average_amount_received_from_peer": 36875.0,
"last_day_received_from_peer": "2024-02-15 00:00:00",
"last_amount_received_from_peer": 15000.0
},
"payments": {
"total_amount_paid": 1360796.0,
"max_amount_paid": 956000.0,
"number_of_times_paid": 14,
"average_amount_paid": 97199.71428571429,
"last_day_paid": "2024-02-19 00:00:00",
"last_amount_paid": 51700.0
}
}

  1. Bad Request Response
400 Bad Request
message: "<The specific error message>"

  1. Unprocessable Entity
422 Unprocessable file entity
message: "Unprocessable File Entity"

  1. Rate Limit Error
429 Rate Limited Error
message: "Rate limited resource",
nexttime:"19876543"

Rate Limiting!

Rate Limited Resource Continous Access will lead to blocking an account.

  1. Internal Server Error
500 Internal Server Error
message: "An Internal Server Error",